home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 4 / Info_Mac IV CD-ROM (Pacific HiTech Inc.)(August 1994).iso / Sound / Utilities / Midi Typer Distribution / !Read Me First! (Text) next >
Text File  |  1994-05-14  |  9KB  |  125 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10. Midi Typer
  11. (Version 1.0)
  12.  
  13. 1. What is it?
  14.  
  15. The short answer
  16.  
  17. Midi Typer is a drag-and-drop utility. It convinces your system that all those MIDI files you downloaded (or bought) really are MIDI files. This is often a problem with MIDI files created for other computer systems, even though the data format for MIDI files is identical among all computer systems. 
  18.  
  19. Midi Typer is smart enough to automatically distinguish between real MIDI files and other kinds of documents (such as this documentation), so you can just drop the icon of a folder or disk on Midi Typer, and it will do the rest. You can also use Midi Typer to change the application that will open your Midi Files.
  20.  
  21. Midi Typer requires System 7.0 or greater.
  22.  
  23. The long answer
  24.  
  25. Macintosh users who download MIDI files (or buy them from commercial collections) are often faced with the problem that their MIDI software refuses to recognize the downloaded file—they won’t even show up in the standard Open File dialog. The problem is that the Finder thinks your MIDI files are really text-only documents. (This description is somewhat simplified; the “How does it really work?” section goes into more detail.) 
  26.  
  27. You can, of course, solve this problem by using any of a number of utilities (ResEdit and DeskTop come to mind immediately), but you have to manually change information for each file individually. With Midi Typer, you just drag a bunch of icons onto Midi Typer, and it does the rest. You can also specify an application to open your Midi Files with, so that you can double-click on the Midi File and have it opened in your favorite sequencer, notation program, or Max.
  28.  
  29. There are other utilities for automatically changing file types. Midi Typer is unique in that it actually looks at the data in your file to check if it is, indeed, a MIDI File. There’s no point in trying to open a “Read Me” document with your sequencer. 
  30.  
  31. 2. How much does it cost?
  32.  
  33. Nothing. You must, however, read Section 6 (“Legal Stuff”) before you may use Midi Typer. 
  34.  
  35. 3. How does it work?
  36.  
  37. The first time you use Midi Typer, you should open the application directly (either select Midi Typer and choose Open from the File menu or double-click on Midi Typer’s icon). You can choose which MIDI program you want to open your MIDI files with from the Open With menu (Figure 1). If your MIDI program is not listed in the menu, choose Select Other Application, and you can specify any application you want to in a standard Open File dialog (Figure 2).
  38.  
  39. Once you’ve specified which MIDI Application to use, go back to the Finder, select your Midi Files, drag them over to Midi Typer, and when Midi Typer’s icon is highlighted, just drop ’em. When you’re finished with Midi Typer, you can quit the application.
  40.  
  41. Once you’ve specified your sequencer, you can just drag-and-drop files, folders, and even entire disks onto Midi Typer. It will make all the necessary changes and quit automatically. If you ever want to change the application used to open your Midi files, just open Midi Typer and make the appropriate choice in the Open With menu.
  42.  
  43. The current version of Midi Typer provides almost no feedback while it’s running. This is regrettable; however, processing is generally over so soon (I get about 10 files/second on a Mac IIfx) that I haven’t felt the effort involved in creating a progress dialog was justified. 
  44.  
  45. If you would like to see improvements made, write to me. My address is at the end of this document. Don’t expect too much—this is a freeware project.
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61. 4. How does it really work?
  62.  
  63. The following information is of a technical nature. You do not need to understand it to use Midi Typer.
  64.  
  65. The problem with most downloaded MIDI files (and with MIDI files taken from other systems) is that the files have the OSType 'TEXT' instead of 'Midi' in the file type field of the Finder Information record. Midi Typer looks at every file dropped on it and, if the first 20 bytes comprise a valid MIDI file Header Chunk, changes the file type and creator fields. I considered making Midi Typer look at the entire file, but all MIDI software I know of makes sanity checks while interpreting MIDI Files, so the chosen solution seems satisfactory. It is also fast enough that a progress dialog is not absolutely necessary. 
  66.  
  67. Midi Typer is based on Paul Hoffman’s Dragonsmith application framework (v. 1.1.1) and was developed using Think C (v. 6.01). If you want to write your own drag-and-drop applications, you can find Dragonsmith at a number of archive sites—try the Info-Mac archives at Sumex-aim (ftp:\\sumex-aim.stanford.edu) or the archives at University of Michigan. Dragonsmith relies several on several System 7.0 features (in particular, Apple Events), so don’t expect any joy under older system versions.
  68.  
  69. If you are familiar with Dragonsmith, you will know that a number of its features can be modified with a resource editor. The Open With menu is also resource based (I don’t mean just a MENU resource, it also uses the custom resource type CREA, for which a template is provided.) You may tinker with the values in these resources, but you do so at your own risk. (And, hey, if you start adding creators that I don’t know about, drop me a line, so I can add them to the next version of Midi Typer.)
  70.  
  71. 5.    Limitations and room for improvement
  72.  
  73. •    No progress indicator. Not a problem for ten to twenty files, but if you drop your hard disk on Midi Typer, the program will need some time. At least it works cooperatively in the background and you can interrupt it with Command-Period.
  74.  
  75. •    Similarly, no notification of errors. 
  76.  
  77. •    Midi Typer trusts you when you select an application using the Select Other Application command. If you tell it that you want to open your MIDI files with Excel, it will obediently do so. I have no idea what Excel will do with a MIDI file. 
  78.  
  79. •    Midi Typer has no Open command in the File menu. The only way to initiate file processing is with drag-and-drop. 
  80.  
  81. •    Midi Typer will not go further than twenty levels deep when looking at folders within folders within folders. This prevents problems that can arise if you put an alias to a folder inside the folder the alias points to (if you know what infinite recursion is, you’ll recognize the problem).
  82.  
  83. •    Some future version of Midi Typer may offer you an option to strip off those stupid .MID suffixes from the file name. 
  84.  
  85. •    Warning: If you used a pre-release version of Midi Typer, you must delete the old Preferences file (inside the Prefences folder in your System Folder). It is incompatible with this version of Midi Typer.
  86.  
  87. 6.    Legal Stuff
  88.  
  89. •    Copyright
  90.  
  91. The Midi Typer is copyright © 1994 by Peter Castine. All rights reserved.
  92.  
  93. •    License
  94.  
  95. Midi Typer (the Software) is provided by Peter Castine (the Author) free of charge and may be distributed free of charge, provided that this documentation is included unchanged with the software. YOU MAY NOT SELL THE SOFTWARE, NOR MAY YOU TAKE A FEE OR COMMISSION FOR PROVIDING THE SOFTWARE TO ANOTHER PERSON, NOR MAY YOU INCLUDE THE SOFTWARE WITH OTHER SOFTWARE THAT IS SOLD FOR A FEE WITHOUT PRIOR WRITTEN PERMISSION FROM THE AUTHOR. Permission is herewith granted for making the software available on electronic data services (‘Bulletin Boards’) and FTP-Archive Servers providing that the documentation and software are included without change or abridgment.
  96.  
  97. •    Disclaimer of Warranty on Software
  98.  
  99. THE SOFTWARE IS PROVIDED “AS IS” AND WITHOUT WARRANTY OF ANY KIND. The Author expressly disclaims all warranties, express or implied, including, but not limited to, the fitness for a particular purpose. The Author does not warrant that the software will be uninterrupted or error-free, or that defects in the software will be corrected. Furthermore, the Author does not warrant or make any representations regarding the use or the results of the use of the software  in terms of their correctness, accuracy, reliability, or otherwise. No oral or written information or advice given by the Author shall create a warranty or in any way increase the scope of this warranty. Should the software prove defective, you (and not the author) assume the entire cost of all necessary servicing, repair or correction of the software, or the computer system with which it is used.
  100.  
  101. •    Limitation of Liability
  102.  
  103. UNDER NO CIRCUMSTANCES, INCLUDING NEGLIGENCE, SHALL THE AUTHOR BE LIABLE FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES THAT RESULT FROM THE USE OR INABILITY TO USE THE SOFTWARE, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  104.  
  105.  
  106.  
  107. That’s it. Note that, at the time of this writing, I have every reason to believe that the software will work as advertised and that it will not cause any damage. I just cannot test it on every possible Macintosh configuration, so, caveat emptor.
  108.  
  109. 7. Praise, Complaints, Offers of jobs…
  110.  
  111. Send them all to:
  112.  
  113. Peter Castine
  114. Wildganssteig 28
  115. 13503 Berlin
  116. Germany
  117.  
  118. e-mail:    pcastine@prz.tu-berlin.de
  119.  
  120. If your favorite MIDI program is not currently on the menu, you can send me a postcard with the program’s name and creator code. I’ll get it into the next version of Midi Typer. If you send the information by e-mail, I’ll e-mail the new version back to you. 
  121.  
  122.  
  123. 13 May, 1994        Midi Typer Documentation
  124.  
  125.